struct NamedObject * nameSpace STRPTR name struct NamedObject * lastObject
LOCATION
In UtilityBase at offset 40
FUNCTION
This function will search through a given NameSpace, or the
system global NameSpace to find a NamedObject with the name
requested. Optionally you can have the search start from a
specific NamedObject. This way you can look for each occurence
of a specifically named NamedObject in a NameSpace that allows
for duplicates.
INPUTS
nameSpace
The NameSpace to search through. If NULL will use
the system default NameSpace.
name
The name of the object to search for. If NULL,
any and all NamedObjects will be matched.
lastObject
The (optional) last NamedObject to start the search
from.
RESULT
If a NamedObject with the name supplied exists, it will be returned.
Otherwise will return NULL.
When you have finised with this NamedObject, you should call
ReleaseNamedObject( NamedObject ).
NOTES
If you are going to use a returned NamedObject to be the starting
point for another search you must call ReleaseNamedObject() AFTER
searching, as the ReleaseNamedObject() call can cause the NamedObject
to be freed, leaving you with an invalid pointer.